Skip to content

feat[STM32][inputcapture]: Support multiple capture channels and paired-edge modes - #12052

Merged
Rbb666 merged 2 commits into
RT-Thread:masterfrom
wdfk-prog:stm32_inputcapture
Nov 17, 2026
Merged

Rbb666 merged 2 commits into
RT-Thread:masterfrom
wdfk-prog:stm32_inputcapture

Conversation

@wdfk-prog

@wdfk-prog wdfk-prog commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

拉取/合并请求描述:(PR description)

为什么提交这份PR (why to submit this PR)

现有 STM32 Input Capture 驱动以物理定时器为单位注册设备,每个 TIM 只能选择一个捕获通道,无法充分利用同一定时器的多个输入捕获通道,也缺少基于 CH1/CH2 配对的 PWM Input 和双边沿采集模式。

本次扩展 STM32 Input Capture 驱动,使一个物理 TIM 可以注册多个独立 EDGE 设备,同时支持按定时器选择独占式 PWM Input 或 DUAL_EDGE 模式。

你的解决方案是什么 (what is your solution)

  1. 支持多通道独立 EDGE 采集

    • TIM1~TIM4 可以分别选择 CH1~CH4。
    • 同一物理定时器的不同通道可以注册为独立的 RT-Thread Input Capture 设备。
    • 不同通道共享物理定时器的计数器、预分频器和 HAL 句柄,分别维护捕获状态。
  2. 增加 PWM Input 模式

    • 使用 CH1/CH2 直接与间接输入捕获配对。
    • 使用定时器 Slave Reset 模式计算 PWM 周期及高、低电平持续时间。
    • 该模式独占对应物理 TIM,不与其他独立 EDGE 设备混用。
  3. 增加 DUAL_EDGE 模式

    • 使用 CH1/CH2 分别捕获同一输入信号的不同边沿。
    • 不使用 Slave Reset,保留自由运行计数器。
    • 在中断处理中根据捕获时间戳计算相邻边沿间隔。
    • 该模式同样独占对应物理 TIM。
  4. 调整 BSP 配置

    • 在 Kconfig 中增加 TIM1~TIM4 的采集模式和独立通道选择项。
    • 将设备名称、数字滤波、捕获极性及 ARR 等板级参数放入 F1/H7 的 inputcapture_config.h。
    • 保持 TIM 外设时钟、GPIO 和中断初始化由板级 HAL MSP 负责。
  5. 调整驱动内部结构

    • 每个物理 TIM 维护一个共享 HAL 句柄。
    • 每个逻辑 Input Capture 设备维护独立状态。
    • 根据捕获通道分发 HAL 中断回调。
    • 增加采集启动、停止和硬件配置失败时的错误处理及日志。

当前拉取/合并请求的状态 Intent for your PR

必须选择一项 Choose one (Mandatory):

  • 本拉取/合并请求是一个草稿版本 This PR is for a code-review and is intended to get feedback
  • 本拉取/合并请求是一个成熟版本 This PR is mature, and ready to be integrated into the repo

代码质量 Code Quality:

我在这个拉取/合并请求中已经考虑了 As part of this pull request, I've considered the following:

  • 已经仔细查看过代码改动的对比 Already check the difference between PR and old code
  • 代码风格正确,包括缩进空格,命名及其他风格 Style guide is adhered to, including spacing, naming and other styles
  • 没有垃圾代码,代码尽量精简,不包含#if 0代码,不包含已经被注释了的代码 All redundant code is removed and cleaned up
  • 所有变更均有原因及合理的,并且不会影响到其他软件组件代码或BSP All modifications are justified and not affect other components or BSP
  • 对难懂代码均提供对应的注释 I've commented appropriately where code is tricky
  • 代码是高质量的 Code in this PR is of high quality

@github-actions github-actions Bot added BSP: STM32 BSP related with ST/STM32 BSP labels Nov 12, 2026
@github-actions

Copy link
Copy Markdown

👋 感谢您对 RT-Thread 的贡献!Thank you for your contribution to RT-Thread!

为确保代码符合 RT-Thread 的编码规范,请在你的仓库中执行以下步骤运行代码格式化工作流(如果格式化CI运行失败)。
To ensure your code complies with RT-Thread's coding style, please run the code formatting workflow by following the steps below (If the formatting of CI fails to run).


🛠 操作步骤 | Steps

  1. 前往 Actions 页面 | Go to the Actions page
    点击进入工作流 → | Click to open workflow →

  2. 点击 Run workflow | Click Run workflow

  • Use workflow from 保持默认分支(通常为 master)
    Keep the default branch (usually master) in Use workflow from
  • 在 branch 输入框填写 PR 分支 stm32_inputcapture
    Enter PR branch stm32_inputcapture in the branch field
  • 设置需排除的文件/目录(目录请以"/"结尾)
    Set files/directories to exclude (directories should end with "/")
  1. 等待工作流完成 | Wait for the workflow to complete
    格式化后的代码将作为独立提交推送至你的分支。
    The formatting changes will be pushed to your branch as a separate commit.

完成后,提交将自动更新至 stm32_inputcapture 分支,关联的 Pull Request 也会同步更新。
Once completed, commits will be pushed to the stm32_inputcapture branch automatically, and the related Pull Request will be updated.

如有问题欢迎联系我们,再次感谢您的贡献!💐
If you have any questions, feel free to reach out. Thanks again for your contribution!

@github-actions

github-actions Bot commented Nov 12, 2026 •

Copy link
Copy Markdown

📌 Code Review Assignment

🏷️ Tag: bsp_stm32

Reviewers: @Liang1795 @hamburger-os @wdfk-prog

Changed Files (Click to expand)
  • bsp/stm32/libraries/HAL_Drivers/drivers/Kconfig
  • bsp/stm32/libraries/HAL_Drivers/drivers/config/f1/inputcapture_config.h
  • bsp/stm32/libraries/HAL_Drivers/drivers/config/h7/inputcapture_config.h
  • bsp/stm32/libraries/HAL_Drivers/drivers/drv_inputcapture.c
  • bsp/stm32/libraries/HAL_Drivers/drivers/drv_inputcapture.h

📊 Current Review Status (Last Updated: 2026-11-17 08:32 CST)


📝 Review Instructions

  1. 维护者可以通过单击此处来刷新审查状态: 🔄 刷新状态
    Maintainers can refresh the review status by clicking here: 🔄 Refresh Status

  2. 确认审核通过后评论 LGTM/lgtm
    Comment LGTM/lgtm after confirming approval

  3. PR合并前需至少一位维护者确认
    PR must be confirmed by at least one maintainer before merging

ℹ️ 刷新CI状态操作需要具备仓库写入权限。
ℹ️ Refresh CI status operation requires repository Write permission.

@github-actions

github-actions Bot commented Nov 12, 2026 •

Copy link
Copy Markdown

MemBrowse Memory Report · Explore what changed →

No memory changes detected for:


Catch memory regressions in CI with MemBrowse. Free for open source.

@Rbb666 Rbb666 left a comment •

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

复核提交 ffe46c7(作者回复后代码未变):仍保留 REQUEST_CHANGES,但修正上一轮范围。第二条接受业务层按物理 TIM 串行管理 init/open/close,不再强制驱动内置共享锁,已降为非阻塞使用契约建议并更新原行内评论。仍需修复的两项是:1. EDGE 重开前清理当前通道残留 CCIF/CCOF,避免旧 CCR 跨计数基准造成虚假脉宽;3. DUAL_EDGE 首次/重同步后持续成对 pending 时应推进状态,避免持续无输出。两项都可在单个控制线程、正常输入波形下触发,不能仅由业务线程锁解决。已在原讨论逐条补充触发条件和最小修改方向。验证为精确源码、F1/H7 HAL 启停逻辑及宿主寄存器模型:EDGE 模型复现 64836 us 虚假脉宽,恢复本通道清标志后后续完整脉宽正常;DUAL_EDGE 1 kHz/1% 占空比、100 周期含16位回绕时,records=0、first_edge=1、overcaptures=0。未做实板验证。当前 Scan code format and license 失败已查明为 clang-format 违规,请修复相应格式并补充目标板验证后再合并。

@wdfk-prog
wdfk-prog requested a review from Rbb666 November 13, 2026 01:44
…ed-edge modes

- Support independent EDGE capture devices on multiple channels of the same physical timer.

- Add exclusive PWM Input and dual-edge capture modes using paired TIM channels.

- Share HAL timer handles while maintaining independent capture device states and interrupt dispatch.

- Extend Kconfig selections and F1/H7 configuration headers for per-channel capture settings.
@wdfk-prog

Copy link
Copy Markdown
Contributor Author

复核提交 ffe46c7(作者回复后代码未变):仍保留 REQUEST_CHANGES,但修正上一轮范围。第二条接受业务层按物理 TIM 串行管理 init/open/close,不再强制驱动内置共享锁,已降为非阻塞使用契约建议并更新原行内评论。仍需修复的两项是:1. EDGE 重开前清理当前通道残留 CCIF/CCOF,避免旧 CCR 跨计数基准造成虚假脉宽;3. DUAL_EDGE 首次/重同步后持续成对 pending 时应推进状态,避免持续无输出。两项都可在单个控制线程、正常输入波形下触发,不能仅由业务线程锁解决。已在原讨论逐条补充触发条件和最小修改方向。验证为精确源码、F1/H7 HAL 启停逻辑及宿主寄存器模型:EDGE 模型复现 64836 us 虚假脉宽,恢复本通道清标志后后续完整脉宽正常;DUAL_EDGE 1 kHz/1% 占空比、100 周期含16位回绕时,records=0、first_edge=1、overcaptures=0。未做实板验证。当前 Scan code format and license 失败已查明为 clang-format 违规,请修复相应格式并补充目标板验证后再合并。

  • 已对所以意见进行回复与修改

@wdfk-prog wdfk-prog closed this Nov 17, 2026
@wdfk-prog wdfk-prog reopened this Nov 17, 2026
@Rbb666
Rbb666 merged commit 0dffe47 into RT-Thread:master Nov 17, 2026
23 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

BSP: STM32 BSP related with ST/STM32 BSP

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants